home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat1 / pmtime.z / pmtime
Text File  |  1997-04-03  |  5KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMTTTTIIIIMMMMEEEE((((1111))))                                                            PPPPMMMMTTTTIIIIMMMMEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmttttiiiimmmmeeee - Performance Co-Pilot time control server
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ppppmmmmttttiiiimmmmeeee [----aaaa] [----hhhh] ----pppp _p_o_r_t_n_a_m_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmttttiiiimmmmeeee provides a graphical user interface for PCP applications requiring
  16.      time control.  ppppmmmmttttiiiimmmmeeee is not normally invoked directly by users.  Rather,
  17.      it is run by calling the Performance Metrics Application Programming
  18.      Interface (PMAPI) function ppppmmmmTTTTiiiimmmmeeeeCCCCoooonnnnnnnneeeecccctttt(3).
  19.  
  20.      The ----pppp argument is required.  When ppppmmmmttttiiiimmmmeeee starts, it creates _p_o_r_t_n_a_m_e in
  21.      the file system.  This is a Unix domain socket serving as the control
  22.      port that ppppmmmmttttiiiimmmmeeee will accept new connections on.
  23.  
  24.      When starting, ppppmmmmttttiiiimmmmeeee creates and initializes an instance of the
  25.      VVVVkkkkPPPPCCCCPPPPaaaarrrrcccchhhhiiiivvvveeeeTTTTiiiimmmmeeee(3) ViewKit dialog (when run with ----aaaa) or an instance of
  26.      the VVVVkkkkPPPPCCCCPPPPlllliiiivvvveeeeTTTTiiiimmmmeeee(3) dialog (when run with the ----hhhh option).  In live mode,
  27.      ppppmmmmttttiiiimmmmeeee will also invoke the ssssttttaaaarrrrtttt(((()))) method of VVVVkkkkPPPPCCCCPPPPlllliiiivvvveeeeTTTTiiiimmmmeeee(3).  The
  28.      dialog will be initially managed (visible) only if the client requested
  29.      it, as described in ppppmmmmTTTTiiiimmmmeeeeCCCCoooonnnnnnnneeeecccctttt(3).
  30.  
  31.      ppppmmmmttttiiiimmmmeeee will then enter it's main loop, accepting new connections and
  32.      sending time control IPC messages to it's client(s).  These messages are
  33.      described in detail in ppppmmmmttttiiiimmmmeeee(3).
  34.  
  35.      When the number of connected clients reaches zero, ppppmmmmttttiiiimmmmeeee will remove the
  36.      control socket and exit.  Clients disconnect either by calling
  37.      ppppmmmmTTTTiiiimmmmeeeeDDDDiiiissssccccoooonnnnnnnneeeecccctttt(3) or simply exiting (implicitly closing the socket
  38.      connections).
  39.  
  40.      The arguments to ppppmmmmttttiiiimmmmeeee are as follows;
  41.  
  42.      ----aaaa   Use archive mode.  This instructs ppppmmmmttttiiiimmmmeeee to create an instance of
  43.           the VVVVkkkkPPPPCCCCPPPPaaaarrrrcccchhhhiiiivvvveeeeTTTTiiiimmmmeeee(3) class, allowing full VCR control.  This
  44.           argument is mutually exclusive with ----hhhh.
  45.  
  46.      ----hhhh   Use live (host) mode.  This instructs ppppmmmmttttiiiimmmmeeee to create an instance
  47.           of the VVVVkkkkPPPPCCCCPPPPlllliiiivvvveeeeTTTTiiiimmmmeeee(3) class.  This argument is mutually exclusive
  48.           with ----aaaa.
  49.  
  50.      ----pppp   Specifies the path to the control port, as described above.  If
  51.           _p_o_r_t_n_a_m_e already exists, ppppmmmmttttiiiimmmmeeee will display an error message and
  52.           exit.  When ppppmmmmttttiiiimmmmeeee exits, it removes _p_o_r_t_n_a_m_e.
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmttttiiiimmmmeeee(3), VVVVkkkkIIIInnnnppppuuuutttt(3x), VVVVkkkkPPPPCCCCPPPPaaaarrrrcccchhhhiiiivvvveeeeTTTTiiiimmmmeeee(3x),
  56.      VVVVkkkkPPPPCCCCPPPPlllliiiivvvveeeeTTTTiiiimmmmeeee(3x), VVVVkkkkPPPPCCCCPPPPttttiiiimmmmeeeerrrr(3x), XXXXttttMMMMaaaaiiiinnnnLLLLoooooooopppp(3x), XXXXttttAAAAppppppppAAAAddddddddIIIInnnnppppuuuutttt(3x)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.